Node / meshtastic / Meshtastic-Android / files / docs / _includes / language_switcher.html

Displaying Raw • Download

{% comment %}

Language switcher for translated docs pages.

Renders a dropdown-style link list showing available translations of the current page.

Include this in any page or layout that should offer locale switching.

Usage: {% include language_switcher.html %}

Logic:

- Dynamically detects the current language and page name.

- Dynamically updates the switcher button's native language name.

- Correctly matches English pages to translated equivalents and vice versa.

- Pre-verifies existing files to only render valid, non-404 options.

{% endcomment %}

{% assign current_path = page.path %}

{% assign locales = site.data.locales %}

{% if locales and current_path %}

{% assign path_parts = current_path | split: "/" %}

{% assign first_segment = path_parts[0] %}

{% comment %}

Identify the current page's language code and native language name.

If the first segment is defined in locales.yml, we are on a translation.

Otherwise, we are in default English.

{% endcomment %}

{% if locales[first_segment] %}

{% assign current_lang_code = first_segment %}

{% assign current_lang_name = locales[first_segment].name %}

{% else %}

{% assign current_lang_code = "en" %}

{% assign current_lang_name = "English" %}

{% endif %}

{% comment %}

Extract the relative base path (independent of locale prefix and file extension).

E.g., "en/user/connections.md" and "be-rBY/user/connections.md" both resolve to "user/connections".

{% endcomment %}

{% assign remaining_parts = path_parts | slice: 1, path_parts.size %}

{% assign base_path = remaining_parts | join: "/" | replace: ".md", "" %}

{% comment %}

Pre-render the dropdown list items.

{% endcomment %}

{% capture dropdown_items %}

{% if current_lang_code != "en" %}

{% if base_path == "index" %}

{% assign en_path = "en/" %}

{% else %}

{% assign en_path = "en/" | append: base_path %}

{% endif %}

Tb4b4b4<Tff7b72liTb4b4b4>Tb4b4b4<Tff7b72a Te6edf3hrefTff7b72=Ta5d6ff"{{ en_path | relative_url }}" Te6edf3langTff7b72=Ta5d6ff"en"Tb4b4b4>EnglishTb4b4b4<Tb4b4b4/Tff7b72aTb4b4b4>Tb4b4b4<Tb4b4b4/Tff7b72liTb4b4b4>

{% endif %}

{% for locale in locales %}

{% assign locale_code = locale[0] %}

{% assign locale_info = locale[1] %}

{% if locale_code == current_lang_code %}

{% continue %}

{% endif %}

{% assign locale_file = locale_code | append: "/" | append: base_path | append: ".md" %}

{% assign page_exists = false %}

{% for p in site.pages %}

{% if p.path == locale_file %}

{% assign page_exists = true %}

{% break %}

{% endif %}

{% endfor %}

{% if page_exists %}

{% if base_path == "index" %}

{% assign locale_path = locale_code | append: "/" %}

{% else %}

{% assign locale_path = locale_code | append: "/" | append: base_path %}

{% endif %}

Tb4b4b4<Tff7b72liTb4b4b4>Tb4b4b4<Tff7b72a Te6edf3hrefTff7b72=Ta5d6ff"{{ locale_path | relative_url }}" Te6edf3langTff7b72=Ta5d6ff"{{ locale_code }}" {% Te6edf3if Te6edf3locale_info.Te6edf3dir Tff7b72=Ta5d6ff= "Te6edf3rtl" %}Te6edf3dirTff7b72=Ta5d6ff"rtl"{% Te6edf3endif %}Tb4b4b4>{{ locale_info.name }}Tb4b4b4<Tb4b4b4/Tff7b72aTb4b4b4>Tb4b4b4<Tb4b4b4/Tff7b72liTb4b4b4>

{% endif %}

{% endfor %}

{% endcapture %}

{% assign dropdown_items_stripped = dropdown_items | strip %}

{% comment %}

Only render the switcher if there is at least one other language option available.

{% endcomment %}

{% if dropdown_items_stripped != "" %}

Tb4b4b4<Tff7b72details Te6edf3classTff7b72=Ta5d6ff"language-switcher" Te6edf3aria-labelTff7b72=Ta5d6ff"Language options"Tb4b4b4>

Tb4b4b4<Tff7b72summary Te6edf3classTff7b72=Ta5d6ff"language-switcher-btn" Te6edf3titleTff7b72=Ta5d6ff"View in another language"Tb4b4b4>

🌐 Tb4b4b4<Tff7b72span Te6edf3classTff7b72=Ta5d6ff"lang-current"Tb4b4b4>{{ current_lang_name }}Tb4b4b4<Tb4b4b4/Tff7b72spanTb4b4b4>

Tb4b4b4<Tb4b4b4/Tff7b72summaryTb4b4b4>

Tb4b4b4<Tff7b72ul Te6edf3classTff7b72=Ta5d6ff"language-switcher-list"Tb4b4b4>

{{ dropdown_items }}

Tb4b4b4<Tb4b4b4/Tff7b72ulTb4b4b4>

Tb4b4b4<Tb4b4b4/Tff7b72detailsTb4b4b4>

{% endif %}

{% endif %}